Ferramenta: Ação de contexto

A ferramenta Ação de contexto (context_action) dispara um webhook quando uma condição descrita em texto acontece durante a conversa — por exemplo, "se o cliente mencionar o concorrente X" ou "se o cliente pedir cancelamento".

Configuração

Campo	Descrição
Contexto	Descrição, em texto livre, de quando o agente deve acionar esta ferramenta. É essa mesma descrição que instrui o modelo sobre o gatilho.
URL do webhook	Endereço que recebe a chamada quando a ferramenta é acionada. Obrigatório.
Variáveis	Lista de dados que o agente deve extrair da conversa e enviar junto no webhook.

Variáveis

Cada variável tem:

• Rótulo — nome amigável exibido no cadastro.
• Chave — identificador técnico usado no payload (somente letras minúsculas, números e _).
• Tipo — texto, número, booleano ou seleção. Para o tipo seleção, é preciso informar as opções disponíveis.
• Obrigatório — se marcado, o agente deve preencher a variável para acionar a ferramenta.

É necessário configurar pelo menos uma variável por ferramenta.

Como funciona

Quando a condição descrita no contexto ocorre na conversa, o Rouxinol envia um POST para a URL do webhook com o contexto, os dados da chamada (id, número do chamador, agente) e as variáveis extraídas. Se a chamada ao webhook falhar, o erro é registrado nos logs, mas a conversa continua normalmente.

Use esta ferramenta para integrar o agente a fluxos externos como CRM, automações de marketing ou alertas internos, sem precisar de um endpoint com autenticação — a chamada é sempre um POST simples com o payload em JSON.